﻿<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <title>TrayTip</title>


  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

  <link href="../css/commands.css" rel="stylesheet" type="text/css">

  <link href="../css/print.css" rel="stylesheet" type="text/css" media="print">

</head>


<body>

<h1>TrayTip</h1>


<p>在托盘图标处创建一个气泡消息窗口。要求 Windows 2000/XP 或以上操作系统。</p>

<p class="CommandSyntax">TrayTip [, Title, Text, Seconds,
Options]</p>

<h3>参数 </h3>

<table border="1" bordercolor="#c0c0c0" cellpadding="3" cellspacing="0" width="100%">

  <tbody>

    <tr>

      <td>Title</td>

      <td>
      <p>如果省略所有参数，当前显示的任何气泡消息窗口将被移除。</p>

      <p>否则，此参数是窗体的标题，最长 73 字符（超出此长度将不显示）。</p>

      <p>如果 <em>Title</em> 为空，标题行将完全不显示，使窗口垂直距离缩短。</p>

      </td>

    </tr>

    <tr>

      <td width="15%">Text</td>

      <td width="85%">
      <p>如果省略此参数或留空，当前显示的任何气泡消息窗口将被移除。</p>

      <p>否则，指定要显示的信息，会在 <em>Title </em>下方显示。只显示 <em>Text
      </em>的前 265 字符。回车符(`r)或换行符(`n)可以被用来创建多行文本。例如：行1`n行2</p>

      <p>如果 <em>Text</em> 较长，可通过 <a href="../Scripts.htm#continuation">continuation section</a>(连
续章节) 分割成若干较短的行，来提高程序的可读性和可维护性。</p>

      </td>

    </tr>

    <tr>

      <td width="15%">Seconds</td>

      <td width="85%">
      <p>窗体显示的大概的秒数，之后它将被操作系统自动地移除。指定一个小于 10 或大于 30 的数字，通常会被最小值
(10) 或最大值 (30) 的显示时间代替。如果省略或留空，通常会采用最小时间。此参数可以是 <a href="../Variables.htm#Expressions">expression</a>(表达
式)。</p>

      <p>真实的时间可能不同于指定的时间。Microsoft
解释说，&ldquo;如果没有显示用户正在使用计算机，系统会不将此段时间计入。&rdquo;(技术细节请看 <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/shellcc/platform/shell/reference/structures/notifyicondata.asp">这
里</a>。)因此，为了精确控制托盘窗口的显示，可使用 <a href="Sleep.htm">Sleep</a>
命令紧跟不带参数的 TrayTip，或像下方示例中使用 <a href="SetTimer.htm">SetTimer</a>
。</p>

      </td>

    </tr>

    <tr>

      <td>Options</td>

      <td>
      <p>指定一下数字中的一个，会在 <em>Title</em> 左侧显示小图标：</p>

      <p>1: 消息图标<br>

2: 警告图标<br>

3: 错误图标 </p>

      <p>如果省略，默认为 0，无图标显示。此参数可以是 <a href="../Variables.htm#Expressions">expression</a> 。<br>

      </p>

      </td>

    </tr>

  </tbody>
</table>

<h3>注意</h3>

<p> TrayTip 要求 Windows 2000/XP 或以上的操作系统。在 Windows 9x/NT 上此命令不起作用。</p>

<p>如果脚本没有托盘图标(通过 <a href="_NoTrayIcon.htm">#NoTrayIcon</a>
或 <em><a href="Menu.htm">Menu</a>, tray,
NoIcon</em>)，那么 TrayTip 气泡窗体不能被显示。同样地，如果下列的 REG_DWORD 值已存在，并已被设为
0 ，那么 TrayTip&nbsp;不会起作用：<br>

HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced
&gt;&gt; EnableBalloonTips</p>

<p>当显示一个气泡窗体时，操作系统通常会播放一个声音。可通过加上 16 到 <em>Options&nbsp;</em>参
数来关闭此声音(例如 16 是无声音无图标，17 是无声音有信息图标，等等。)</p>

<p>做一个相关提示，每当用户将鼠标悬停在脚本托盘图标上时，会有提示显示。提示内容可以通过：<em><a href="Menu.htm">Menu</a>, Tray, Tip, 我的新文本</em>
来改变。</p>

<h3>相关命令</h3>

<p><a href="ToolTip.htm">ToolTip</a>, <a href="SetTimer.htm">SetTimer</a>, <a href="Menu.htm">Menu</a>, <a href="SplashTextOn.htm">SplashTextOn</a>, <a href="MsgBox.htm">MsgBox</a>, <a href="InputBox.htm">InputBox</a>, <a href="FileSelectFile.htm">FileSelectFile</a>, <a href="FileSelectFolder.htm">FileSelectFolder</a></p>

<h3>示例</h3>

<pre class="NoIndent">TrayTip, My Title, Multiline`nText, 20, 17<br><br><em>; 为了更精确的控制显示时间</em><br><em>; 而不使用 Sleep (其会停止当前线程):</em><br>#Persistent<br>TrayTip, Timed TrayTip, 此文本将被显示 5 秒。<br>SetTimer, RemoveTrayTip, 5000<br>return<br>RemoveTrayTip:<br>SetTimer, RemoveTrayTip, Off<br>TrayTip<br>return<br><em>; 为了让 TrayTip 永久显示, 使用 timer 来周期性地进行刷新：</em><br>SetTimer, RefreshTrayTip, 1000<br>Gosub, RefreshTrayTip <em>; 调用一次来让它马上开始。</em><br>return<br>RefreshTrayTip:<br>TrayTip, Refreshed TrayTip, 这是一个更持久的 TrayTip 。, , 16<br>return</pre>

</body>
</html>
